home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 096 / sysopclr.hqp / sysopclr.hlp
Text File  |  1985-01-07  |  11KB  |  203 lines
  1.                 RBBS-PC SYSOP ANSI.SYS COLOR HELP
  2.  
  3.               Adding Ansi Color to your WELCOMEG File
  4.  
  5.                          By: Greg Rismoen
  6.  
  7.  
  8.    The ANSI.MRG for PC-TALK was written by Ken Nickerson and allows users
  9. of PC-TALK to take advantage of IBM's ANSI color graphics and music when
  10. calling RBBS-PC Bulletin Boards.  Ken Nickerson, using IBM equipment, and
  11. his limited access system, was the first to make all the enhancements
  12. available to the general public.  Kent Galbraith was the first SYSOP to
  13. implement ANSI color on his RBBS system (data: 713-635-8254 or 713-360-1316)
  14. 24 hours, using IBM equipment.  Mike Freeman next implemented ANSI color
  15. on RBBS-PC using a COMPAQ-driven system (24hr data: 713-481-0455).  My
  16. system was the third IBM-driven RBBS system to implement ANSI color
  17. (data 212-819-7942 hours 6pm - 8:30am weekdays 24hrs weekends).
  18.  
  19.    In order for a Caller to receive color and music from an RBBS, the
  20. Caller needs to have the statement:  DEVICE=ANSI.SYS in the CONFIG.SYS
  21. file (and reboot system), plus PC-TALK with ANSI.MRG applied (merged),
  22. plus DOS 2.x operating system.
  23.  
  24.    The SYSOP needs to run RBBS-PC version CPC12.2A (or later), and have
  25. the appropriate Escape codes in the WELCOMEG file.  Please read chapter
  26. 13 of the DOS 2.0 Manual for a very brief summary of escape codes.
  27.  
  28.    The Escape codes will allow you to issue special character sequences
  29. to the Caller which will permit screen formatting, color graphics and
  30. music to be executed for the Caller.
  31.  
  32.    The Escape Code is ASCII 027 and Hex 1B and cannot be issued within
  33. EDLIN or DOS.  The normal procedure is to use a dummy variable to represent
  34. the Esc code and then go into DEBUG and replace the dummy variable with
  35. Hex 1B.  However, Volkswriter, Volkswriter Delux and PC-WRITE (freeware)
  36. issue a true ESC code when the ESC key is depressed.  If you have access
  37. to one of these word processing programs, you can set up your graphics
  38. first, then go into the word processing program and insert the ESC codes
  39. to enable color graphics and music.  However, appended to this help file
  40. is a program known as SGR.TXT (or CLR.TXT) which contains true ESC codes
  41. which can be copied over to your WELCOMEG file using the "T" Transfer function
  42. of EDLIN (if last line in your file is 99, then issue:  100Tsysopclr.hlp
  43. and you will append this file to the end of your WELCOMEG file).  Then
  44. copy and delete as appropriate to move the ESC codes to where they are
  45. needed.
  46.  
  47. BEGINNING OF YOUR FILE:
  48.  
  49.    All ANSI color/music/format statements have the format:
  50.  
  51.       nn;nn;x  where nn is a valid number and x is an alpha operand.
  52.  
  53.         set attributes off (0);bold on (1);white f/g (37);
  54.                      and blue background (44)
  55.  
  56.                   NOTE: If you are copying the ESC codes, rather than
  57.                         inserting them, it is a good procedure to use
  58.                         two digit numbers, like 00,01,05, because it will
  59.                         be easier to later edit lines of code which
  60.                         are copied and have a pair of ESC codes in the line,
  61.                         such as, ESC[[00;17;01jESC[[00;01;05;32m
  62.  
  63.  
  64.    At the beginning of your file you will want a format command to
  65. start the text in the middle of the screen so the Caller will have
  66. time to read it as it scrolls upward.
  67.  
  68.    1;f  The first 0 turns off any attributes the caller has set
  69.                   on his/her own system before calling your RBBS.  The
  70.                   second statement starts text at line 17 column 1 and the
  71.                   "f" operand is for format.
  72.  
  73.   Your second line should specify the color, with bold (highlight) on or
  74. off and blinking (05) on or off:
  75.  
  76.    "1" turns bold on; "37" white foreground; "44" blue
  77.                  background; "m" designates Set Graphics Rendition mode
  78.  
  79.    Now, if you do nothing else, the callers screen will start on the
  80. 17th line in the first column, and will stay bold white letters on a
  81. blue background.  The text/graphics will scroll normally from the 17th
  82. line and the color will not change until the caller signs off.
  83.  
  84.       j   inserted at the end of the first 23 lines of graphics
  85.                 on line 24, will return to white on black and erase the
  86.                 screen and place the curser on the home position.
  87.  
  88.         inserted on line 25 will turn green foreground and black
  89.                 (default) background on, until the next ESC code is read.
  90.                  bold is now off and blinking is off (due to the 0; cmd)
  91.  
  92.         turns bold on and green f/g with (default) black b/g.
  93.  
  94.    You can insert ESC codes inside graphic frames to change the color
  95. of the lettering inside the frame, leaving the frame a different color:
  96.  
  97. ╔═══════════════════════════════════════════════════════════════════╗
  98. ║                                                                   ║
  99. ║              This line is a different color                       ║
  100. ║                                                                   ║
  101. ╚═══════════════════════════════════════════════════════════════════╝
  102.  
  103.    Please notice that the ESC codes are INSERTED and place the vertical
  104. bars out of alignment, even though they will display correctly (try:
  105. TYPE SYSOPCLR.HLP to see display if you have ANSI.SYS in your CONFIG.SYS).
  106. For this reason, we recommend constructing your graphics first, and then
  107. INSERT the ESC codes using PC-WRITE or Volkswriter, or, dummy the ESC codes
  108. with a line editor like EDLIN and use DEBUG to replace the variable with
  109. a true ESC (HEX 1B).
  110.  
  111. FORMATTING
  112.  
  113.    The ESC[[xx;yy;F command will format the screen where xx is column number
  114. and yy is line number.  You can either start the screen at column x and
  115. line y and then let it scroll normally, or you can continue to format the
  116. screen, by subsequent ESC[[xx;yy;f commands telling the cursor where to
  117. start printing the line of text which follows the format statement.
  118. After the last format statement, the text will continue to scroll normally.
  119. Just remember if you continue formatting you will have less control over
  120. where the page breaks will fall, but trial and error will get you through.
  121.  
  122.      Once you are through formatting, and wish to check how the screen
  123. breaks will occur for the Callers using PageLength=23, go into EDLIN
  124. specifying WELCOMEG and at the system prompt hit L for List and it will
  125. list the first 23 lines of text, which will be the initial screen your
  126. Callers will see.  Insert or delete blank lines, as required, to get the
  127. first screen to line up.  Then enter 24L to list the second 23 lines of
  128. text, which will be the second screen the Callers will see, as so on.
  129.  
  130. MUSIC
  131.  
  132.    Music works just like the BASIC PLAY statement, except the Music
  133. Background statement (MB) will not work in RBBS-PC.  The format is:
  134.  
  135. MFOx.............................................
  136.  
  137. where M represents Music, F represents Foreground, O represents Octave
  138. and x represents Octive number (0 - 6) for the music to follow.  If you
  139. have ten lines of code for the song, each line must begin with ESC[[,
  140. but only the first line requires the ESC[[MFOx code.  The ESC-N at the
  141. end of the line will print a musical note graphic, and is not required.
  142.   In place of ESC[[MF you can use ESC[[MS for staccato or ESC[[MST150
  143. for Staccato Tempo 150 (tempo default is 120 quarter notes in a minute).
  144. You might try creating your music with a music generator like BLUESBOX.BAS
  145. and then append the resulting code to your WELCOMEG and copy it to the
  146. correct line number and insert the required ESC[[ at the start of each
  147. line of music code.
  148.  
  149.  
  150. CLOSING YOUR FILE
  151.  
  152. You should close your WELCOMEG file with an ESC[[00 to turn off the colors,
  153. highlighting and flashing or it will continue on the Callers screen
  154. throughout the session, and may interfere with readability.
  155.  
  156.    If you wish to leave color on, remember some Callers will have monochrome
  157. screens and some colors are almost unreadable on monochrome, which
  158. defeats the purpose of having a Bulletin Board System.  We recommend
  159. leaving yellow on black, green on black, or white on blue:
  160.  
  161.  
  162.   Bold on; yellow foreground; black background
  163.   Bold on; green foreground; black background
  164.   Bold on; white foreground; blue background
  165.  
  166. OTHER USES FOR ANSI.CLR
  167.  
  168.    Remember, you can use the ANSI colors in batch files, menus and
  169. whatever, and it is not limited to your RBBS system.  Give it a
  170. try and color up your system.
  171.  
  172.  
  173. DOS 2.0 SET GRAPHICS RENDITION (SGR) FILE
  174.  
  175. The following file has been appended to this help file and when it is
  176. displayed (using ANSI.SYS) it will demonstrate in the right hand column
  177. how the, say, 32 green foreground looks on 40 black background, on a
  178. RGB color monitor.
  179.  
  180.  
  181. =3h                DOS 2.00 Set Graphics Rendition (SGR) Parameters
  182.                                usage: ESC[#;,,,#m
  183.  
  184. <0> = All Attributes Off (Normal White on Black)  <1> = Bold On
  185. <4> = Underscore On (IBM Monochrome Display Only) <5> = Blink On
  186. <7> = Reverse Video On                            <8> = Cancelled On (Invisible)
  187. BOLD  Background=<40> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  188. OFF   Background=<41> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  189.       Background=<42> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  190.       Background=<43> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  191.       Background=<44> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  192.       Background=<45> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  193.       Background=<46> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  194.       Background=<47> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  195. BOLD  Background=<40> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  196. ON    Background=<41> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  197.       Background=<42> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  198.       Background=<43> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  199.       Background=<44> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  200.       Background=<45> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  201.       Background=<46> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  202.       Background=<47> Foreground=<30> <31> <32> <33> <34> <35> <36> <37>
  203.